CxFmsDashboardCtrl Properties

The CxFmsDashboardCtrl object contains the following properties.

Note: Time format selection is not available in this control. The Dashboard control displays data in Contract time (C).

General Properties

Browse by letter:     [A]     [B]     [C]     [D]     [E]     [F]     [P]     [R]     [S]     [U]     [V]

Property SubType Read Only Description

Appearance

Integer

No

Returns/sets the appearance of the object boundary

Possible values for this property are as follows.

  • 0 – Flat
  • 1 – 3D

Default value is 0 - Flat.

AttributeDisplaySettingsXml

String

No

Returns/sets the XML specifying the colors and cell values that will appear on the FMS Dashboard control

Another way to configure this property is to use the OCX Properties dialog box (click the Dashboard page, then click Configure display properties).

See Configuring Dashboard Display Properties for more information about display settings.

BeginDate

String

No

Note: This property is only used if the UseSessionOptions property is set to 0 - No.

Returns/sets the starting date of the FMS Dashboard control

This string can be in one of the following forms.

  • Absolute date - for example: 1/31/2023
  • Relative date - for example: T (today), T-14 (14 days prior to today), or T+1 (one day following today)

Default value is T-7.

See Selecting Date and Time for more information.

BorderStyle

Integer

No

Returns/sets the border style

Possible values for this property are as follows.

  • 0 - None
  • 1 - Fixed single border

Default value is 0 - None.

ChooserAllowMultiSelect

Boolean

No

Returns/sets whether or not the user can select multiple Nodes in the Node chooser. Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 1 - Yes.

ChooserFilterString

String

No

Returns/sets the filter string to be used when retrieving Nodes of the type specified by the ChooserFilterType property, in the control Node Chooser

Wildcard values * (multiple character) and ? (single character) are supported. Wildcards can be used in any part of the string to specify that any character or set of characters is allowed in its place.

Example

A filter string of "*Test*" will retrieve all Nodes with the word "Test" somewhere in the string, such as "TestDevice" or "MyTestDevice" or "Device001Test".

Default value is * (multiple character wildcard)

ChooserFilterType

Integer

No

Returns/sets the Node property that will be filtered by the string specified by the ChooserFilterString property, in the control Node Chooser

Possible values for this property are as follows.

  • 0 – Name
  • 1 – Description
  • 2 – ID

Default value is 0 - Name.

ChooserGroupSelection

String

No

Returns/sets the group currently selected in the Node chooser’s Group combo box

ChooserNodeCategorySelection

Integer

No

Returns/sets the Node category currently selected in the Node chooser’s Node category combo box

Possible values for this property are as follows.

  • 1 - Node_Category1_Device
  • 2 – Node_Category1_Group
  • 3 – Node_Category1_Station
  • 6 - Node_Category1_Any
  • 8 – Node_Category1_Gas_Device
  • 9 - Node_Category1_Liquid_Device

Default value is 6 - Node_Category1_Any.

ChooserNodeCategoryVisible

Boolean

No

Returns/sets whether or not the Node chooser’s Node category combo box is visible

Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 1 - Yes.

ChooserPrimarySortColumn

Integer

No

Returns/sets the primary sort column of the Node chooser’s Node list

Possible values for this property are as follows.

  • 0 - Type ascending
  • 2 - Name ascending
  • 3 - Description ascending
  • 4 - Type descending
  • 5 - Name descending
  • 6 - Description descending

Default value is 2 - Name ascending.

ChooserSiteServiceSelection

String

No

Returns/sets the Site.Service currently selected in the Node chooser’s FMS combo box

ChooserSiteServiceVisible

Boolean

No

Returns/sets whether or not the Node chooser’s FMS combo box is visible

Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 1 - Yes.

CmdDefinitionXml

String

No

Returns/sets the XML specifying the custom FMS commands configured for the control

Another way to configure this property is to use the OCX Properties dialog box (Command page).

ColumnsXml

String

No

Returns/sets the XML specifying the columns that will appear on the control

Another way to configure this property is to use the control-specific property page in the CygNet FMS Control Properties dialog box. See CygNet FMS Dashboard Control for more information.

CustomColumnsUpdateInterval

Integer

No

Returns/sets the update interval, in number of seconds, for the custom data columns, as configured in the Admin Options, if displayed in the control

See Using the Dashboard Control for more information.

DataMode

Integer

No

Returns/sets the data mode for viewing summary data

Possible values for this property are as follows.

  • 1 – Device_Mode
  • 3 – Station_Mode

Default value is 1 - Device_Mode.

DataView

Integer

No

Returns/sets the data view that will be displayed in the FMS Dashboard control [supersedes the deprecated VisibleAttribute property]

When the DataMode property is set to 1 - Device_Mode, data view options are as follows.

  • 0 – DataQuality
  • 1 – HasConfig
  • 2 – OpenExceptions
  • 3 – LinkExceptions
  • 4 – EditState
  • 5 – CollectStatus
  • 6 - CollectStatusDetail
  • 7 - ExportStatus
  • 8 - AnalystOverview

Default value is 0 - DataQuality.

When the DataMode property is set to 3 - Station_Mode, valid data view options are as follows.

  • 0 – DataQuality
  • 2 – OpenExceptions
  • 4 – EditState
  • 8 - AnalystOverview

Default value is 0 - DataQuality.

DateTimeDisplayMode

Integer

No

Returns/sets whether dates displayed in the control will have the time appear before the date (leading) or after the date (trailing)

Possible values for this property are as follows.

  • 0 – LeadingTime
  • 1 – TrailingTime

Default value is 0 - LeadingTime.

EndDate

String

No

Note: This property is only used if the UseSessionOptions property is set to 0 - No.

Returns/sets the ending date of the FMS Dashboard control

This string can be in one of the following forms.

  • Absolute date - for example: 1/31/2023
  • Relative date - for example: T (today), T-14 (14 days prior to today), or T+1 (one day following today)

Default is T.

See Selecting Date and Time for more information.

FilterConfigXml

String

No

Returns/sets the XML string specifying the filter settings to use for data display in the control

Filter property options correspond to data view selection. See Configuring Dashboard Filters for more information about available filter settings corresponding to each data view.

Possible values for these properties are as follows.

  • 0 — No
  • 1 — Yes

Default value is 1 - Yes for all options.

Another way to configure this property is to use the OCX Properties dialog box (click the Dashboard tab, then Filter).

Font

StdFont

No

Returns/sets the font used by the control

Click to access the Font dialog box to make font selections.

Default value is MS Shell Dlg.

PITDateTime

String

No

Note: This property is only used if the UsePIT property is set to 1 - Yes.

Returns/sets the Point in Time date and time of the FMS Dashboard control

This string can be in one of the following forms.

  • Absolute Date/Time - for example: 1/31/2023 7:10:14 AM
  • Relative Date/Time - for example: y-1 m-2 d=15 H=5 M=30 S=0
  • Relative Day - an offset from the current day T, for example, T-10

Default value is T, date and time today.

See Using the Home Menu for more information about PIT mode.

RecordOrder

Integer

No

Returns/sets the order in which records will be displayed

Possible values for this property are as follows.

  • 0 - Oldest _First
  • 1 - Newest_First

Default value is 0 - Oldest_First.

SessionNodeClickOption

Integer

No

Returns/sets selection behavior for setting the Session Node

Possible values for this property are as follows.

  • 0 - SingleClick
  • 1 - DoubleClick

Default value is 1 - DoubleClick.

SessionBeginDate

String

No

Note: This property is only used if the UseSessionOptions property is set to 1 - Yes.

Returns/sets the Session starting date for the time window displayed in the control 

This string can be in one of the following forms.

  • Absolute date - for example: 1/31/2023
  • Relative date - for example: T (today), T-14 (14 days prior to today), or T+1 (one day following today)

See Selecting Date and Time for more information.

Note: Because Session options are universal to all FMS controls, this property can only be set via script during runtime, and the value is not saved to the control.

SessionEndDate

String

No

Note: This property is only used if the UseSessionOptions property is set to 1 - Yes.

Returns/sets the Session ending date for the time window displayed in the control

This string can be in one of the following forms.

  • Absolute date - for example: 1/31/2023
  • Relative date - for example: T (today), T-14 (14 days prior to today), or T+1 (one day following today)

See Selecting Date and Time for more information.

Note: Because Session options are universal to all FMS controls, this property can only be set via script during runtime, and the value is not saved to the control.

SessionNodeTag

String

No

Note: This property is only used if the UseSessionNode property is set to 1 - Yes.

Returns/sets the Session Node tag, which specifies the active Node in the FMS Dashboard control

This tag must be in the form SITE.SERVICE|ID (for example, TEST.FMS|2540).

Note: Because Session options are universal to all FMS controls, this property can only be set via script during runtime, and the value is not saved to the control.

ShowChooserPane

Boolean

No

Returns/sets whether or not the Chooser pane will be displayed in the control

Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 1 - Yes.

ShowCustomColumns

Boolean

No

Returns/sets whether to show custom columns, as configured in the Admin Options (Custom Dashboard Columns page)

Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 0 - No.

ShowExceptionCount

Boolean

No

Returns/sets whether or not the FMS Dashboard control will display a fixed column showing the number of exceptions for a Node

Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 1 - Yes.

ShowNodeDescription

Boolean

No

Returns/sets whether or not the FMS Dashboard control will display a fixed column showing the Node description

Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 1 - Yes.

ShowNodePriority

Boolean

No

Returns/sets whether or not the FMS Dashboard control will display a fixed column showing the Node priority

Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 0 - No.

ShowOptionsPane

Boolean

No

Returns/sets whether or not the Options pane will be displayed in the control

Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 1 - Yes.

ShowPercentMissing

Boolean

No

Returns/sets whether or not the control will display a fixed column showing the percentage of missing data for a Node

"Missing data" means records with a collection status of anything other than Good or Partial.

Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 1 - Yes.

ShowUseFilterButton

Boolean

No

Returns/sets whether or not the FMS Dashboard control will display the Use filter button in the control

Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 1 - Yes.

UseFilterConfig

Boolean

No

Returns/sets whether or not to use the configured filter values (FilterConfigXml) to determine what data to display in the control

Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 0 - No.

UsePIT

Boolean

No

Returns/sets whether or not the PITDateTime property will be used

Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 0 - No.

UseSessionNode

Boolean

No

Returns/sets whether to use the SessionNodeTag property [if set to 1 - Yes] or to present a Chooser page for Node selection [if set to 0 - No] to specify the active Node in the control

Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 0 - No for this control.

Note: Default value varies by control type.

UseSessionOptions

Boolean

No

Returns/sets whether to use the SessionBeginDate and SessionEndDate properties [if set to 1 - Yes] in place of the BeginDate and EndDate properties [if set to 0 - No]

Possible values for this property are as follows.

  • 0 - No
  • 1 - Yes

Default value is 0 - No for this control.

Note: Default value varies by control type.

VisibleAttribute

Integer

No

Note: This property deprecated in favor of DataView

Returns/sets the data view that will be displayed in the FMS Dashboard control

See DataView for details.

Back to top